-
Notifications
You must be signed in to change notification settings - Fork 89
API Issues #373
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
API Issues #373
Conversation
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Requested changes, please see the comments.
|
||
Follow the steps below: | ||
|
||
- **Set Proper Request Headers** |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These are steps, should this be numbered bullets or dot bullets?
|
||
`Content-Type: application/json` | ||
|
||
`Charset: utf-8` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
There are two headers that needs to be added, shouldnt there be bullets?
|
||
This guide will help you understand the most common API error codes and how to fix them. | ||
|
||
## What is an API? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Remove this sub topic and add a single line about APIs such as To learn more about APIs, check out our API documentation guide and point it to our API docs. You can find it if you search for it. Please reference other guides to learn how we hyperlink internal docs.
Your request isn’t properly formatted. This could be due to a missing parameter, a typo, or incorrect syntax. | ||
|
||
:::tip | ||
Check the API documentation to ensure you're including the correct fields and headers. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Check the API documentation to ensure you're including the correct fields and headers. | |
Check the API's own documentation to ensure you're including the correct fields and headers. |
The API server took too long to respond. Try simplifying your request or reducing the size of the data being sent. | ||
|
||
:::tip[Final tips] | ||
- Always check the API documentation, inspect your request, and look up error messages. If the issue persists, contact the API provider. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Always check the API documentation, inspect your request, and look up error messages. If the issue persists, contact the API provider. | |
- Always check the API's own documentation, inspect your request, and look up error messages. If the issue persists, contact the API provider. |
|
||
:::tip[Final tips] | ||
- Always check the API documentation, inspect your request, and look up error messages. If the issue persists, contact the API provider. | ||
- Once you fix the issue, your calls should return a `200 OK`—which means everything is working as expected! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- Once you fix the issue, your calls should return a `200 OK`—which means everything is working as expected! | |
- Once you fix the issue, your calls should return a `200 OK`, which means everything is working as expected! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Refrain from using double dashes in our documentation, please change everywhere.
|
||
Ensuring the security of API keys is a critical aspect of building and maintaining a safe and reliable application. In the realm of private API calls, it's especially important to make sure your API keys are not exposed. This article aims to provide a best-practices guide on where to place your API keys to increase security in a FlutterFlow environment. | ||
|
||
## The Misconception: Private API Calls Secure Everything |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this doesnt need to be h2, just bold heading is fine.
|
||
Many users assume that simply marking an API call as 'private' is enough to protect all associated data. However, this is not the case. Private API calls run in a Cloud Function, which means any keys or sensitive data in the body will be secure — as long as they're not passed in from the frontend. Even in private API calls, if you're loading an API key from the frontend (like from Firebase remote configs), then you're still exposing it. | ||
|
||
## Where to Put Your API Keys |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not a good title, please think of an alternative
``` | ||
The key should never be a variable that gets passed in from the frontend, as that would make it accessible via the client-side code, defeating the purpose of using private API calls for secure operations. | ||
|
||
## How to verify that your key is secured |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Refrain from using "How to" in titles , update the title accordingly and all our titles are written in Title Case.
slug: /understanding-api-errors | ||
title: Understanding API Errors | ||
--- | ||
# Understanding API Errors |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Whats the difference between this doc and client server errors doc? seems like similar info, merge the info and create a single doc.
Description
Provide a brief overview of what this documentation update is about. Explain what sections or topics are being added or revised.
Linear ticket and magic word Fixes DEVR-942
Type of change